FEATURE ARTICLE 



by Lane Hauck 



Add USB to Anything 

Need to make a USB peripheral? Now you can add USB to any microprocessor with the new 
Maxim MAX3420E, which operates as a full-speed USB peripheral. Lane shows you how. 
He also describes the code he used to create a Windows Panic button. 



A.rtic 



icles about Universal Serial Bus 
(USB) used to begin by justifying it as 
the new connection standard for PCs. 
Thankfully, that's no longer necessary, 
so this introduction will be mercifully 
short. If you have an embedded sys- 
tem and want to connect to a PC, the 
mainstream conduit is USB. 

In this article I'll introduce Maxim's 
MAX3420E. This new chip makes it 
easy to add USB to any system. I'll 
focus on the SPI and provide you with 
example C code for a generic SPI 
implementation. I'll conclude by 
describing some code for a simple USB 
human interface device (HID):. a 
Windows Panic button. 

MAX3420E ADVANTAGE 

Many designers choose microproces- 
sors based on integrated peripherals. 
Some processors include USB func- 
tionality, but most don't, especially 
the inexpensive ones. Have you ever 
picked a microprocessor with the per- 
fect combination of I/O and peripher- 
als but found that it lacked USB? 
Wouldn't it be nice to design a USB 
peripheral without having to buy new 
tools and learn another processor? 

You can add USB to any micro- 
processor with the MAX3420E, which 




Figure 1— The USB 5-V wire powers this USB 
widget. The SPI can be three, lour, or five pins. The 
MAX3420E gives back more I/O pins than it uses for 
the SPI. 



has a USB full-speed transceiver, an 
intelligent USB serial interface engine 
(SIE), and an SPI slave interface that 
can run with an SCK clock signal up 
to 26 MHz. The MAX3420E operates 
as a full-speed USB peripheral with 
one control endpoint, two double- 
buffered, 64-byte bulk data endpoints, 
and one 64-byte interrupt endpoint. 

BUS-POWERED WIDGET 

Figure 1 illustrates a common USB 
peripheral architecture. The USB V BUS 
wire provides 5-V power to a 3.3 -V 
regulator, which powers the micro- 
processor and the MAX3420E. (No 
wall wart!) The SPI can comprise 
three, four, or five wires. The basic SPI 
signals are the serial clock (SCK), the 
chip select (CS) — which frames an SPI 
transfer — the master out, slave in data 
(MOSI), and the master in, slave out 
data (MISO). Some interfaces can com- 
bine MOSI and MISO as a bidirection- 
al pin, thus creating a three-pin inter- 
face. 

The MAX3420E also provides an 
interrupt pin to reduce traffic over the 
SPI. Instead of exercising the SPI port 
to poll bits for USB activity, a micro- 
processor can simply poll the INT 
pin for activity or, for more com- 
plex systems, use it as an actual 
interrupt. 

What if the microprocessor does- 
n't have an SPI port? No problem. 
It's extremely easy to make a 
firmware-driven SPI master by 
directly toggling general-purpose 
I/O pins. A strong feature of USB is 
that it's self-throttling; it automat- 
ically accommodates any speed 
interface on the SPI side. The 



MAX3420E takes advantage of this by 
using a NAK handshake on the USB 
side to indicate to the host PC that it's 
busy and the host PC should try again 
later. Many USB peripherals, especial- 
ly those connected to humans, can 
operate responsively with even the 
slowest SPI. 

What if the microprocessor in 
Figure 1 is really small, say, less than 
10 pins? Should you use precious I/O 
pins just to talk to the USB chip? Yes. 
The MAX3420E has four general-pur- 
pose inputs and four general-purpose 
outputs to replace the pins used to 
talk to it, and then some. Consequently, 
your system actually gains I/O pins 
after connecting a MAX3420E. 

The MAX3420E isn't restricted to 
small systems. Figure 2 illustrates 
how to add USB functionality to an 
ASIC, FPGA, DSP, or other large chip. 
An obvious reason to do this is that 
the big chip may not have USB built 
in, or the USB inside may not be 
exactly what you want. 

But there's another good reason for 
this architecture. As large chips 
shrink in process geometries, they're 
less able to touch high voltages like the 
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Figure 2— The MAX3420E isn't confined to small systems. 
Internal level shifters take care of interface voltages lower 
than 3.3 V. The SPI port can run as fast as 26 MHz. 
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3.3-V USB signalling voltage and to pro- 
vide the spec-required immunity from a 
possible 5.5-V V BUS to data line short 
circuit, (Not to mention ESD protec- 
tion. Remember, the USB connector is 
exposed to the user environment.) The 
external USB chip with a low-voltage 
SPI is a good answer. To run the low- 
voltage interface, the MAX3420E has 
internal level shifters and a VL pin to 
set the interface pins' operating volt- 
age to between 1.7 and 3.6 V. 



The SPI is also an easy place to 
put an optical isolator (see Figure 3). 
You can program the SPI to run rela- 
tively slowly to support low-cost 
optoisolators. 

SPI 

An SPI is a simple serial interface 
that uses two data lines, a serial clock, 
and a chip-select signal. The SPI mas- 
ter drops *CS low to start a transfer. It 
then drives the serial clock SCK to 



Listing 1— The bit-banging routines are for reading and writing MAX3420E registers. By customizing the low- 
level macros, these routines can be used lor any microprocessor. These SPI functions use only general-pur- 
pose I/O pins. 



#define SCK_HI 
#define SCK_L0 
#define CS_HI 
#define CS_L0 
#define MOSI(v) 
#define MISO 

BYTE rreg(BYTE r) 



OUTA = PINSA I 0x02; 

OUTA = PINSA & OxFD; 

OUTA = PINSA | 0x04; 

OUTA = PINSA & OxFB; 

OUTA = (PINSA & 0x7F) | (v & 0x80); 
inval l= PINSA & 0x01; 

// Read a register r, return its value. 



{ 

int j; 

BYTE bv.inval ; 
inval = 0; 
CS_L0 

bv = r«3; // Left-shift the reg number, WRITE=0 

for (j=0; j<8; {// Send the register number and direction bit 

MOSI(bv) // Put out a bit 

bv «= 1; // Shift 1 bit left 

SCK_HI 

SCK_L0} 

for (j=0; j<7; j++) {// Get 7 bits and shift left into 'inval' 
SCK_HI 
MISO 

inval «= 1; // Shift in 1 bit 
SCKJ.0} 

SCK_HI // One more bit, but don't shift 'inval' this time 

MISO 

SCK_L0 

CS_HI 

return inval; 

} 



// Return the byte we read in 



void wreg(BYTE r , BYTE v)// Write register r with value v 
{ 

int j; 
BYTE bv; 
CS_L0 



bv = (r«3)+2; 


// 


Left-shift the reg number, set 


the WRITE 


direction bit 








for (j=0; j<8; j++){ 


// 


Send the register number and di 


recti on bit 


MOSI(bv) 


// 


Put out a bit 




bv «= 1; 


// 


Shift one bit left 




SCK HI 








SCK_L0} 








for (j=0; j<8; j++){ 


// 


Send the register data 




MOSI(v) 


// 


Put out a bit 




v «= 1; 


// 


Shift one bit left 




SCK HI 








SCK LO} 









CS_HI 
} 
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Figure Z—The SPI provides a convenient way to isolate 
the USB port from the controller. The SPI signals are unidi- 
rectional and can be relatively slow (e.g., 1-MHz SCK), 
which allows you to use low-cost optoisolators. 



simultaneously clock data in and out of 
a slave device. The SPI master termi- 
nates a transfer by returning *CS high. 

The SPI has four clocking modes 
reflecting two mode signals: clock 
polarity (CPOL) and clock phase 
(CPHA). These signals are represented 
as (CPOL, CPHA). It turns out that an 
interface that expects positive-edge 
SCKS and also expects the MOSI data 
to be available before the first positive 
clock edge can operate in (0,0) and 
(1,1) modes without alteration. This 
property allows the MAX3420E to 
operate in (0,0) or (1,1) mode without 
requiring a mode pin. 

Figure 4 illustrates a data transfer 
between the MAXQ2000 microproces- 
sor and the MAX3420E using SPI 
modes (0,0) and (1,1). The difference is 
the inactive level of the SCK signal: 
low for mode (0,0) and high for mode 
(1,1). The MAX3420E accepts a com- 
mand byte as the first byte of every 
transfer. The command byte contains 
the register number and a direction 
bit. The second and subsequent bytes 
contain data. You may be wondering 
what's coming out of the MAX3420E 
(MISO) while the command byte is 
clocked in (MOSI). These are eight USB 
status bits that are available every time 
a command byte is clocked in. This fea- 
ture is active only for interfaces that 
use separate data pins MISO and MOSI. 

SPI CODE 

The trick to writing general C code 
for the MAX3420E is to isolate the bare 
minimum SPI operations in a separate 
module, and then customize only this 
module from SPI to SPI. At a mini- 
mum, this module needs to do only 
three things: initialize the SPI port, 
read a byte, and write a byte. 

My Panic button features a hard- 
ware SPI unit. For SPI masters that 
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don't have one, let's first look at 
some generic C code for a bit- 
banged SPI. 



BIT-BANGED SPI 

The function that initializes 
the SPI port will change the 
most from processor to proces- 
sor. It is responsible for assign- 
ing the particular I/O pins used 
by the interface, setting their 
directions, and then setting the 
initial conditions of CS = 1 and 
SCK = 0. Note that I'm assum- 
ing a mode (0,0) SPI master. 

Listing 1 shows generic rou- 
tines for reading and writing 
MAX3420E registers. The 
macros at the beginning define the low- 
level pin operations to drive SCK high 
and low, to drive CS high and low, and 
to clock data in and out using the MOSI 
and MISO pins. The macros insulate the 
functions from various I/O schemes of 
various microprocessors. Using macros 
makes the code easy to read and proces- 
sor-independent. The macros in Listing 1 
are for a typical older microprocessor 
that doesn't contain a hardware SPI unit. 

HARDWARE SPI 

Tom Cantrell covered the 
MAXQ2000 last year in "A Simple 
Plan" (Cixcuit Cellar, 170, September 
2004). In brief, the MAXQ2000 is the 
first of a family of low-power, high- 
performance RISC processors from 
Maxim. The "Q" stands for quiet, indi- 
cating that the architecture is designed 
to coexist nicely with sensitive analog 
circuits. As for a USB interface, the 
MAXQ2000 is especially friendly to 
the MAX3420E because it has a built-in 
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Figure 5— The application code runs on the MAXQ2000 
evaluation kit with a small daughter board containing the 
MAX3420E. The port-to-SPI signal assignments serve 
as a reference for reading the program listing. 



Figure i—The top four traces show an SPI operating in mode (0,0). The bot- 
tom four traces show the same interface, sending the same data, but operating 
in SPI mode (1,1). The difference is the quiescent SCK level and when the first 
positive SCK edge occurs. 



SPI port. I used the MAXQ2000 develop- 
ment kit and the MAX3420E to build 
the Windows Panic button (see Figure 5). 

The MAXQ2000 hardware SPI unit 
provides SCK, MOSI, and MISO, but 
not *CS. Because of the variations in 
how *CS operates (e.g., for accessing one 
byte versus a burst of bytes), it's better 
to use a general-purpose I/O pin for *CS. 

Figure 6 illustrates the basic MAXQ 
I/O cell. Every I/O cell has a flip-flop, 
which in this example is written using 
a bit called P05.3. The "O" stands for 
output. You can always write this flip- 
flop. Whether or not it gets connected 
to the pin depends on the direction 
bit. When configuring an output pin, 
it's good practice to write the flip-flop 
before connecting it to the pin. This 
will help you avoid glitches. 

The direction of the P53 pin is set 
by a bit called PD5.3. The "D" stands 
for direction, and the D signal serves 
as the output enable for the pin driver: 
1 = drive and - float. 

The state of the pin can always be 
read in the PI5.3 bit. The "I" stands for 
input. No matter how the pin is driv- 
en, whether by the internal flip-flop 
(PD5.3 = 1) or by something external 
(PD5.3 = 0), the PI bit indicates the 
pin state. 

A nice feature of this structure is 
that if the pin is configured as an 
input (PD5.3 = 0), the output of the 
flip-flop isn't used as an output. As a 
result, you can reuse it as a pull-up resis- 
tor switch. When D = 0, the O signal is 
redefined to connect a pull-up resistor, 
as shown by the dotted line and 



switch in Figure 6. 

Some I/O pins have an 
interrupt capability. Interrupt 
blocks have three signals. A 
flag bit is set when the inter- 
rupt request is active, and the 
CPU resets it. An edge-select 
bit determines whether a 
positive or negative signal 
transition causes the interrupt 
request. And, finally, there's an 
interrupt-enable bit for each 
pin that's capable of request- 
ing an interrupt (see Figure 6). 

For the Panic button, the 
MAX3420E INT output pin is 
configured for a positive 
edge-triggered interrupt. As 
for the MAXQ2000, the code directly 
tests the interrupt flip-flop for a pend- 
ing USB interrupt instead of using the 
MAXQ2000 interrupt system. The 
program does nothing but check the 
status of a push button and respond to 
the USB requests, so a polling loop is 
all that's needed. 

The MAXQ2000's I/O pins are 
shared between general-purpose I/O 
and special-function hardware such as 
the SPI unit. To use special hardware, 
you first configure the hardware block, 
and then enable it to be connected to 
the I/O pins. The S P I_I n i t ( ) routine 
sets pin directions, configures the SPI, 
and finally enables it. 

The rreg and wreg functions in the 
full listing take advantage of the 
MAXQ2000 hardware SPI unit. 
Therefore, they're smaller and faster 
than their bit-banged counterparts. 

PANIC BUTTON 

The Panic button is a one-button 
USB HID keyboard. Pressing it mini- 
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Figure 6— The port bits in this MAXQ I/O cell are 
labeled P.B, where P is the port and B is the bit. This 
one is port 5, bit 3. 
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mizes the active windows, and your 
desktop will appear. Push the button 
again, and the application windows 
will spring back to life. 

Using a USB class driver like HID 
means you don't have to write a 
Windows driver for the USB peripheral 
because Windows (and most other 
operating systems) includes USB class 
drivers. This greatly simplifies the 
task of developing any USB peripheral. 

USB keyboards are interesting. If 
you plug in several, they'll be active at 
the same time. So, my little Panic 
button will work in conjunction with 
your normal keyboard. 

If your PC is in Suspend mode, the 
Panic button can serve as a remote 
wake-up button. This depends on 
whether or not your PC supports the 
wake-up function from USB. Some do, 
some don't. The Panic button will 
help you determine if yours does. 

The code runs on the MAXQ2000 
development kit with a small USB 
daughterboard (containing the 
MAX3420E) plugged into an expan- 
sion connector. The code is actually a 
shorter version of the more extensive 
USB code examples on Maxim's web 
site. You may download the code from 
the Circuit Cellar FTP site. The appli- 
cation contains USB boilerplate code 
that does the nitty-gritty enumeration 
work. The Panic button's personality 
is described by the character arrays in 
the Panic_Button_Enum_Data.h file. 

The Panic button application uses 
two endpoints: the mandatory control 
endpoint zero and EP3-IN, which is a 
single-buffered, 64-byte endpoint. 
Although the MAX3420E con- 
tains two double-buffered, 64- 
byte endpoints (EP1-OUT and 
EP2-IN), the throughput advan- 
tages of double buffering are 
unnecessary in this application. 

It's a common misconception 
that HIDs operate only at USB 
low speeds. This project demon- 
strates that even something as slow 
as a keyboard can benefit from run- 
ning at full speed. It uses less bus 
bandwidth by sending 12 MHz 
instead of 1.5-MHz packets. 

Interrupt endpoints have a 
polling interval that determines 
how often the USB host asks the 



IN endpoint for data. You can expect 
the host to send an I N request to the 
device's endpoint 3 at every interval. 
Figure 7 illustrates the simple state 
machine implemented by the MAXQ 
microprocessor C program that han- 
dles these requests. After the device is 
enumerated, the microprocessor 
repeatedly executes the routine. To 
simplify things, the application polls 
the interrupt pin for activity. But, of 
course, if you have other things going on 
in the microprocessor, you should acti- 
vate the Do_IN3 function interrupt. 

The software state machine uses two 
global variables: state and button. 
C macros define three states: IDLE, 
RELEASE, and WAIT. The state vari- 
able is initialized to IDLE. The button 
variable is high when you press the push 
button connected to the MAX3420E 
GPINO pin and low otherwise. An end- 
less loop in the ma i n ( ) function incre- 
ments a button-check timer. After it 
expires, it reads the GPIO register in the 
MAX3420E to determine button's state. 
This prevents unnecessary SPI traffic. 

While the button is up, the state dia- 
gram takes the two leftward branches 
and does nothing. If you press the but- 
ton when the application is in the 
IDLE state, it will be time to send the 
key code in the following sequence to 
clear the decks of active windows: 08 
00 07. After the next state is set to 
RELEASE, you're done. 08 is the 
Windows key. 07 is reserved. 07 is the 
letter "d." 

As soon as the MAX3420E dispatch- 
es this packet over USB, it generates 
another EP3-IN interrupt request to 



DOJN3 




Send 08 00 07 
state = RELEASE 



Send 00 00 00 
state = WAIT 



State = IDLE 



Figure 7—1 created this flowchart for the Panic button application. The 
algorithm takes only 29 lines of C code. The applications consist of a 
single button attached to a USB port. Pushing the button instantly clos- 
es or restores all the active windows. 



indicate that the EP3-IN FIFO is once 
again available for loading data. The 
function in Figure 7 is reentered and 
State = RELEASE, so the function 
sends the sequence 00 00 00, indicat- 
ing "keys up." 

The next state is WAIT, which 
instructs the application to wait for the 
button to be released. Now all the func- 
tion needs to do is use the WAIT state 
branches to detect when the button is 
released. Nothing happens while the 
button is down. When the button is 
released, the state diagram takes the two 
rightward branches and reinitializes the 
State variable to IDLE, readying the 
function for the next press of the button. 

The code that executes most of the 
time consists of only 23 lines. Check 
out the Do_I N3 function to see how 
the Figure 7 flowchart is implemented. 

CODE TIDBITS 

A few of the details lurking in the 
code deserve comment. The 
MAX3420E signals a remote wake-up 
by driving a K state onto the bus for 
10 ms. To relieve the SPI master from 
the chore of counting off the time, the 
MAX3420E internally times the signal 
(and, in fact, all USB time-sensitive 
events), and then gives the SPI master 
an interrupt when the interval is com- 
plete. The SPI master doesn't need to 
tie up its own timers for these events,- 
it just starts the operation and waits 
for the completion interrupt. 

The rregAS and wregAS functions do 
one thing differently than r r e g and 
wreg: they set an ACK status bit in the 
SPI command byte. The SPI master (the 
MAXQ2000 in this example) uses 
the bit to tell the MAX3420E that 
it has finished servicing the cur- 
rent CONTROL request and to 
terminate the CONTROL transfer 
by ACKing its status stage. ACK- 
STAT also exists as an internal 
register bit, but by including it 
in the SPI command byte, this fre- 
quently used operation can exe- 
cute faster and with less code. 

The readbytesC ) and 
wri tebytes ( ) functions take 
advantage of the MAX3420E's 
bursting capability. Instead of 
sending two SPI bytes per byte 
access (a command byte and a 
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data byte), they drop *CS, send the 
command byte, clock in and out a 
burst of bytes, and finally raise *CS to 
terminate the SPI transfer. 

The product ID string (in the 
Panic_Button_Enum_Data.h file) will 
appear as a short message the first 
time you plug in the Panic button. 
This will pop up during the enumera- 
tion process that identifies the Panic 
button as an HID. It will associate it 
with the built-in Windows driver. 

Every subsequent attachment will be 
silent except for the short Windows 
sound you'll hear when you plug in any 
USB device. If you want to check the 
device status anytime, go to the USB 
Human Interface Device Properties 
screen. You can reach this screen by 
right-clicking My Computer and then 
selecting Properties. Next, click the 
Hardware tab, press the Device Manager 
button (you're almost there), expand the 
Human Interface Devices item, right- 
click on USB Human Interface 
Device, and then select Properties. 
You should see a location and the 
text, "MAX3420E USB Panic Button." 

USB COMPLIANCE 

You may think this is a lot of work 
for a one-button USB device. That's 
because there is a certain amount of 
overhead associated with any USB 
device. Fortunately, USB is so careful- 
ly specified that the enumeration code 
can serve as a template (as in copy 
and paste) for any USB device. 

Like any diligent developer, I want- 
ed my design to be certified by the USB 
Implementers Forum (USB-IF), which 
would give me the right to use the USB 
logo and help ensure that my design 
would function on a PC without any 
problems. I'm happy to report that the 
Panic button passed the USB Command 
Verifier (USBCV version 1.2.1.0) and 
HID tests on the USB-IF's web site. 

NEED A PERIPHERAL? 

If you need to make a USB peripher- 
al, check out the MAX3420E, which is 
small, easy to program, and comes with a 
lot of free example code. The MAX3420E 
will add I/O pins to your design and play 
nicely in any system that has SPI sup- 
port. Because SPI is so easy to bit-bang, 
every microprocessor is included. If 



you want performance, you can clock 
the SPI as high as 26 MHz. S 

Lane Hauck works as a senior scien- 
tist for Maxim Integrated Products. 
He has designed FFT analyzers, video 
games, electronic toys, and USB inte- 
grated circuits. Lane has a B.S. in 
physics, which he never uses, and an 
M.S.E.E., which he does use. He 
enjoys music and digital photography. 
You may contact him at 
Lane_Hauck@maximhq. com. 



PROJECT FILES 



To download the code, go to ftp. circuit 
cellar.com/pub/Circuit_Cellar/2005/180. 



RESOURCE 



USBCV and HID Test information, USB 
Implementers Forum, Inc., www.usb.org. 



SOURCE 



MAX3420E and MAXQ2000 

Maxim Integrated Products 
www.maxim-ic.com 
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Boards designed under EAGLE are found in patient 
monitoring equipment, chip cards, electric razors, hearing 
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small as a thumbnail or as large as a PC motherboard. 
They are developed in one-man businesses or in large 
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► Powerful library management: 
e.g. move devices between 
libraries, base library for 
packages, generate package 
variants from other libraries. 

► Dynamic ratsnest during routing 
process. 

► Copy function in schematic. 

► Rotate components in 0.1- 
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► User-defined background color. 
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tracks. 
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